home *** CD-ROM | disk | FTP | other *** search
/ Nothing but Tetris / Nothing but Tetris.iso / amiga / yactris / yactris.doc < prev    next >
Encoding:
Text File  |  1994-01-01  |  6.4 KB  |  216 lines
  1. Yactris
  2.  
  3.  
  4.  
  5. I.  Introduction
  6.  
  7.  
  8.  
  9. The name Yactris was coined to mean "Yet Another Clone TRIS."  
  10. I'd been having the experience too many times where I start to 
  11. download a file, get bored, and have to go over to my neighbors and 
  12. play Tetris clones on his I*M because I had no truly multitasking 
  13. games for my Amiga.  From this experience, the concept of Yactris was 
  14. born.
  15.  
  16. Yactris is a bare bones Tetris clones.  It doesn't have a lot of 
  17. colors or background graphics for a simple reason.  The Yactris window 
  18. can be opened on any public screen, and uses the pen definitions of 
  19. that screen to determine how it draws the shapes.  This means that you 
  20. can begin a download using, say, Term.  Open Yactris on the Term 
  21. window, and play a game while you're waiting for your download to 
  22. finish.
  23.  
  24. Yactris is entirely system friendly.  It steals nothing, checks 
  25. everything, and at the very least will exit cleanly on a system error.  
  26. It multitasks execellently, and with almost no sluggishness.  It is, 
  27. IMHO, a good example of how Amiga games should be coded in order to be 
  28. system friendly.
  29.  
  30. Enjoy Yactris.
  31.  
  32.  
  33.  
  34. II.  System Requirements.
  35.  
  36.  
  37.  
  38. Yactris should run on any Amiga with OS v2.04 and above.  It has 
  39. been tested on Amiga 3000s running v2.04 and v2.1 without difficulty, 
  40. and I can foresee no reason why it should not work with other 
  41. hardware.
  42.  
  43.  
  44.  
  45. III.  Playing Yactris
  46.  
  47.  
  48.  
  49. Yactris can be executed from either Workbench or the CLI.  Simply 
  50. double-click the icon or type YacTris once you have opened its 
  51. directory to begin.  Yactris will take several command line arguments 
  52. or tooltypes.  They are:
  53.  
  54.  
  55.  
  56. STARTLEVEL=n    Begin play at Level n.  (Default 0)
  57.  
  58.  
  59.  
  60. LINESTOINC=n    Increase the level one after each n lines are 
  61. removed.  (Default 10)
  62.  
  63.  
  64.  
  65. PUBSCREEN=scr    Open Yactris on the Public Screen named scr. 
  66. (If the option is omitted or scr does not 
  67. exist, Yactris opens on the default public 
  68. screen.)
  69.  
  70.  
  71.  
  72. When you first begin Yactris, you will see one window which 
  73. contains the play area, a box displaying the next piece to fall, and 
  74. an area displaying the score, number of lines cleared, and current 
  75. level.  If you don't know what the object of Tetris is, go find a 6-
  76. year-old to tell you.
  77.  
  78. To start the game, select Start from the Game menu.  Pieces will 
  79. begin falling.  Pieces are controlled with the numeric keypad:  '4' 
  80. moves a piece left, '6' moves it right, '5' rotates it, and '2' drops 
  81. it a line.  Simply hold '2' down to drop a piece to the bottom of the 
  82. playfield.
  83.  
  84. If you wish to pause Yactris, either select Halt from the Game 
  85. menu or activate another window.  Reset in the Game menu will clear 
  86. the play area and the scores.
  87.  
  88. If you're a purist who doesn't like to know what's coming next, 
  89. you can toggle the display of the next piece under the Settings menu.  
  90. If don't believe me when I say that piece selection is totally random, 
  91. toggle on Piece Count Display (again under Settings) and see for 
  92. yourself.
  93.  
  94. You can check out the About menu item under Game, but I don't 
  95. know why you'd want to.  And Quit is self expanatory.
  96.  
  97. Last, but not least, if you want to move Yactris to another 
  98. screen, select New Public Screen from the Settings menu.  This will 
  99. bring up a requester window which will allow you to choose a new 
  100. public screen.  Yactris will then move to that screen, pause play, and 
  101. wait.
  102.  
  103. Please Note:  Yactris will WORK on all Public Screens, but it 
  104. will not necessarily look good.  How good Yactris looks depends 
  105. entirely on how well whatever program it was that opened the public 
  106. screen chose its pen values.  Prowrite makes Yactris look extremely 
  107. ugly, and two-color screens aren't that great, either.
  108.  
  109.  
  110.  
  111. IV.  Scoring
  112.  
  113.  
  114.  
  115. Yactris's scoring system is biased toward those of us who play 
  116. suicidally, piling things up and preying for a line.  For every piece 
  117. dropped, the player receives one point.  If a single drop clears one 
  118. line, the player receives ten points.  Two lines cleared yields 100, 
  119. while three gives 1000.  If you can clear four lines at one (a 
  120. Tetris), you receive a whopping 10000 points.
  121.  
  122. The number of lines cleared is also recorded, for those who take 
  123. a more meticulous and foresightful approach to Yactris.
  124.  
  125.  
  126.  
  127. V.  Distribution notes
  128.  
  129.  
  130.  
  131. Yactris is freeware.  It can be freely redistributed under the 
  132. terms of the GNU General Public License, version 1 or later.  A copy 
  133. of the GNU GPL should have been included with this distribution.  If 
  134. not, a copy can be obtained by writing to the Free Software 
  135. Foundation, 675 Mass Ave., Cambridge, MA 02139, USA.
  136.  
  137. You don't have to send anything to anyone if you use Yactris 
  138. (although I'm not so stupid that I didn't include my address :] ).
  139.  
  140.  
  141.  
  142. VI.  Programmers' notes
  143.  
  144.  
  145.  
  146. Under the terms of the GNU GPL you are allowed to modify Yactris 
  147. so long as credit is given where credit is due.  In order to keep this 
  148. program from becoming a total kludge, I'd like to ask a few favors.
  149.  
  150. The easiest way to modify Yactris is by sending a suggestion to 
  151. me and letting me do it.  If you must modify Yactris yourself, please 
  152. send a copy to me.  In addition, do not change the number of the 
  153. version you modified, simply postpend it with a modification version 
  154. number and your initials.  For example, if Paul Strong were to modify 
  155. v0.0 he would number 0.0.1PS.  If Sam Boothe were to modify that, the 
  156. version would become 0.0.1PS.1SB.  I'm hoping that the mess won't get 
  157. that bad, but this method should allow easier tracing of the program's 
  158. evolution.  The easiest way is still sending suggestions to me.  I'll 
  159. be sure to give all suggestions full consideration, and give the 
  160. people who made suggestions that were implemented credit in the 
  161. distribution.
  162.  
  163. Yactris was programmed on Matt Dillon's DICE compiler, about 
  164. which I have only a few gripes, all of which should be fixed as soon 
  165. as I get my hands on the soon-to-be-released new version.  I also used 
  166. Fred Fish's public domain DBUG package.  Since Fred has abandoned the 
  167. copyright on DBUG, I'm including my DICE-modified dbug.c and dbug.h 
  168. source with the distribution.  The entire DBUG package can be found on 
  169. Fish Disk 232.
  170.  
  171.  
  172.  
  173. VII.  To do
  174.  
  175.  
  176.  
  177. o    Add a player routine that will optionally play selected mods 
  178. during a game.
  179.  
  180. o    Option to iconify in the middle of a game.
  181.  
  182.  
  183.  
  184. VIII.  Revision History
  185.  
  186.  
  187.  
  188. 0.0    Initial Release
  189.  
  190.  
  191.  
  192. IX.  The Author
  193.  
  194.  
  195.  
  196. While my college is in session, I can be reached by e-mail at 
  197. "springjp@screech.alfred.edu" or "springjp@ceramics.bitnet".  Snail-
  198. mail will always reach me through this address:
  199.  
  200.  
  201.  
  202. Jonathan Springer
  203.  
  204. 360 W. Main St.
  205.  
  206. Dallastown, PA 17313-2014
  207.  
  208. USA
  209.  
  210.  
  211.  
  212. Enjoy Yactris!
  213.  
  214.  
  215.  
  216.